Functions with Unicode (W) Versions
The following
TAPI functions are implemented in Unicode (W) and ANSI (A) versions. In
general, the implementation of the ANSI version calls the Unicode version and
performs necessary conversions of ANSI parameters and structure fields to and
from Unicode; the following table indicates the parameters that are converted.
Applications
that explicitly call the generic (neither "W" or "A"
suffix) version of a function will execute the ANSI version, for backward
compatibility with previous versions of TAPI.
Note The entire
Telephony Service Provider Interface (TSPI) is Unicode for version 2.0.
In the
following table, references to string fields in TAPI structures consist of a
portion of the field names. For example, the "Caller Address" in the LINEFORWARD structure is pointed to by
a field named dwCallerAddressOffset and delimited by a field named dwCallerAddressSize;
in the table, this string is identified simply as CallerAddress.
|
TAPI
Function |
Parameters
and Structure Fields Converted in ANSI Version of Function |
|
lineAddProvider |
lpszProviderName |
|
lineBlindTransfer |
lpszDestAddress |
|
lineConfigDialog |
lpszDeviceClass |
|
lineConfigDialogEdit |
lpszDeviceClass Note Application
must handle conversion of strings in lpDeviceConfigIn and lpDeviceConfigOut,
if these are directly manipulated. |
|
lineDial |
lpszDestAddress |
|
lineForward |
lpForwardList (LINEFORWARDLIST14KQMDP) ForwardList
(LINEFORWARD)
CallerAddress
DestAddress
lpCallParams (LINECALLPARAMS) OrigAddress
DisplayableAddress
CalledParty
Comment
TargetAddress
DeviceClass
CallingPartyID
|
|
lineGatherDigits |
lpsDigits lpszTerminationDigits |
|
lineGenerateDigits |
lpszDigits |
|
lineGetAddressCaps |
lpAddressCaps (LINEADDRESSCAPSPFGP43) Address
CompletionMsgText
DeviceClasses
CallTreatmentList
(LINECALLTREATMENTENTRY)
CallTreatmentName
|
|
lineGetAddressID |
lpsAddress |
|
lineGetAddressStatus |
lpAddressStatus (LINEADDRESSSTATUSGM12S3) Forward
(LINEFORWARD)
CallerAddress
DestAddress
|
|
lineGetAgentActivityList |
lpAgentActivityList (LINEAGENTACTIVITYLIST) List
(LINEAGENTACTIVITYENTRY)
Name |
|
lineGetAgentCaps |
lpAgentCaps (LINEAGENTCAPS) AgentHandlerInfo
|
|
lineGetAgentGroupList |
lpAgentGroupListI(LINEAGENTGROUPLIST.D1TA5) List
(LINEAGENTGROUPENTRY)
Name |
|
lineGetAgentStatus |
lpAgentStatus (LINEAGENTSTATUSFP.8N.) Activity
GroupList
(LINEAGENTGROUPENTRY)
Name |
|
lineGetAppPriority |
lpszAppFilename lpExtensionName |
|
lineGetCallInfo |
lpCallInfo (LINECALLINFO) CallerID
CallerIDName
CalledID
CalledIDName
ConnectID
ConnectedIDName
RedirectionID
RedirectionIDName
RedirectingID
RedirectingIDName
AppName
DisplayableAddress
CalledParty
Comment
|
|
lineGetCountry |
lpLineCountryList (LINECOUNTRYLISTA_AS4O) CountryList
(LINECOUNTRYENTRY)
CountryName
SameAreaRule
LongDistanceRule
InternationalRule
|
|
lineGetDevCaps |
lpLineDevCaps (LINEDEVCAPS) ProviderInfo
SwitchInfo
LineName
TerminalText
DeviceClasses
Note dwStringFormat
is obsolete. |
|
LineGetDevConfig |
lpszDeviceClass Note Application
must handle conversion of strings in lpDeviceConfig, if these are
directly manipulated. |
|
LineGetIcon |
lpszDeviceClass |
|
lineGetID |
lpszDeviceClass Note Application
must handle conversion of strings in lpDeviceID, if these are directly
manipulated. |
|
LineGetLineDevStatus |
lpLineDevStatus (LINEDEVSTATUS) AppInfo
(LINEAPPINFO) MachineName
UserName
ModuleFilename
FriendlyName
|
|
lineGetProviderList |
lpProviderList (LINEPROVIDERLIST9.AL6V) ProviderList
(LINEPROVIDERENTRY)
ProviderFilename
|
|
lineGetRequest |
lpRequestBuffer (LINEREQMAKECALL szDestAddress
szAppName
szCalledParty
szComment
|
|
lineGetTranslateCaps |
lpTranslateCaps (LINETRANSLATECAPS5PWH.X) CardList
(LINECARDENTRY)
CardName
SameAreaRule
LongDistanceRule
InternationalRule
LocationList
(LINELOCATIONENTRY
LocationName
CityCode
LocalAccessCode
LongDistanceAccessCode
TollPrefixList
celCallWaiting
|
|
lineHandoff |
lpszFileName |
|
lineInitializeEx |
lpszFriendlyAppName |
|
lineMakeCall |
lpszDestAddress lpCallParams (LINECALLPARAMS) OrigAddress
DisplayableAddress
CalledParty
Comment
TargetAddress
DeviceClass
CallingPartyID
|
|
lineOpen |
lpCallParams (LINECALLPARAMS) OrigAddress
DisplayableAddress
CalledParty
Comment
TargetAddress
DeviceClass
CallingPartyID
|
|
linePark |
lpszDirAddress lpNonDirAddress (VARSTRING) String
|
|
linePickup |
lpszDestAddress lpszGroupID |
|
linePrepareAddToConference |
lpCallParams (LINECALLPARAMS) OrigAddress
DisplayableAddress
CalledParty
Comment
TargetAddress
DeviceClass
CallingPartyID
|
|
lineRedirect |
lpszDestAddress |
|
lineSetAppPriority |
lpszAppFilename lpszExtensionName |
|
lineSetDevConfig |
lpszDeviceClass Note Application
must handle conversion of strings in lpDeviceConfig, if these are
directly manipulated. |
|
lineSetTollList |
lpszAddressIn |
|
lineSetupConference |
lpCallParams (LINECALLPARAMS) OrigAddress
DisplayableAddress
CalledParty
Comment
TargetAddress
DeviceClass
CallingPartyID
|
|
lineSetupTransfer |
lpCallParams (LINECALLPARAMS) OrigAddress
DisplayableAddress
CalledParty
Comment
TargetAddress
DeviceClass
CallingPartyID
|
|
lineTranslateAddress |
lpszAddressIn lpTranslateOutput (LINETRANSLATEOUTPUT) DialableString
DisplayableString
|
|
lineTranslateDialog |
lpszAddressIn |
|
lineUnpark |
lpszDestAddress |
|
phoneConfigDialog |
lpszDeviceClass |
|
phoneGetButtonInfo |
lpButtonInfo (PHONEBUTTONINFOLJ8WG_) ButtonText
|
|
phoneGetDevCaps |
lpPhoneCaps (PHONECAPS) ProviderInfo
PhoneInfo
PhoneName
DeviceClasses
Note dwStringFormat
is obsolete. |
|
phoneGetIcon |
lpszDeviceClass |
|
phoneGetID |
lpszDeviceClass Note Application
must handle conversion of strings in lpDeviceID, if these are directly
manipulated. |
|
phoneGetStatus |
lpPhoneStatus (PHONESTATUS) OwnerName
|
|
phoneInitializeEx |
lpszFriendlyAppName |
|
phoneSetButtonInfo |
lpButtonInfo (PHONEBUTTONINFOLJ8WG_) ButtonTest
|
|
tapiGetLocationInfo |
lpszCountryCode lpszCityCode |
|
tapiRequestMakeCall |
lpszDestAddress lpszAppName lpszCalledParty lpszComment |